home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 15 / CU Amiga Magazine's Super CD-ROM 15 (1997)(EMAP Images)(GB)[!][issue 1997-10].iso / CUCD / Graphics / Ghostscript / source / gs-vms.hlp < prev    next >
Text File  |  1997-06-22  |  11KB  |  291 lines
  1. 1 gs
  2.  gs - Aladdin Ghostscript interpreter/previewer
  3. ! This file describes version 5.01 of Aladdin Ghostscript.
  4. ! 22 June 1997
  5.   Usage:
  6.    $ gs [options] [file ...]
  7.  
  8.  Ghostscript is an implementation of Adobe Systems' PostScript (tm)
  9.  language, which is in turn similar to Forth. Gs reads files in sequence
  10.  and executes them as Ghostscript programs. After doing this, it reads
  11.  further input from the standard input stream (normally the keyboard).
  12.  Each line is interpreted separately. To exit from the interpreter,
  13.  enter the `quit' command. The interpreter also exits gracefully if it
  14.  encounters end-of-file. Typing the interrupt character (e.g. Control-C)
  15.  is also safe.
  16.  
  17. 2 Description
  18.  The interpreter recognizes several switches described below, which
  19.  may appear anywhere in the command line and apply to all files
  20.  thereafter.
  21.  
  22.  You can get a help message by invoking Ghostscript with the -h
  23.  or -? option. This message also lists the available devices.
  24.  
  25.  Ghostscript may be built with multiple output devices. Ghostscript
  26.  normally opens the first one and directs output to it. To use
  27.  device xyz as the initial output device, include the switch
  28.      "-sDEVICE=xyz"
  29.  in the command line.  Note that this switch must precede the first
  30.  .ps file, and only its first invocation has any effect. For example,
  31.  for printer output in a normal configuration that includes an Epson
  32.  printer driver, you might use the command
  33.       gs "-sDEVICE=epson" myfile.ps
  34.  instead of just
  35.       gs myfile.ps
  36.  Alternatively, you can type
  37.       (epson) selectdevice
  38.       (myfile.ps) run
  39.  All output then goes to the printer instead of the display until
  40.  further notice. You can switch devices at any time by using the
  41.  selectdevice procedure, e.g.,
  42.       (vga) selectdevice
  43.  or
  44.       (epson) selectdevice
  45.  As yet a third alternative, you can define a logical name GS_DEVICE
  46.  as the desired default device name.  The order of precedence for these
  47.  alternatives, highest to lowest, is:
  48.       selectdevice
  49.       (command line)
  50.       GS_DEVICE
  51.       (first device in build list)
  52.  
  53.  To select the density on a printer, use
  54.       gs "-sDEVICE=<device>" -r<xres>x<yres>
  55.  For example, on a 9-pin Epson-compatible printer, you can get the
  56.  lowest-density (fastest) mode with
  57.       gs "-sDEVICE=epson" -r60x72
  58.  and the highest-density mode with
  59.       gs "-sDEVICE=epson" -r240x72.
  60.  
  61.  If you select a printer as the output device, Ghostscript also
  62.  allows you to control where the device sends its output.  Normally,
  63.  output goes directly to a scratch file on Unix and VMS systems. To
  64.  send the output to a series of files foo1.xyz, foo2.xyz, ..., use
  65.  the switch
  66.       "-sOutputFile=foo%d.xyz"
  67.  The %d is a printf format specification; you can use other formats
  68.  like %02d.  Each file will receive one page of output. Alternatively,
  69.  to send the output to a single file foo.xyz, with all the pages con-
  70.  catenated, use the switch
  71.       "-sOutputFile=foo.xyz"
  72.  
  73.  To find out what devices are available, type
  74.       devicenames ==
  75.  after starting up Ghostscript. Alternatively, you can use the -h or -?
  76.  switch in the command line; the help message also lists the available
  77.  devices.
  78.  
  79.  To select a different paper size, use the command line switch
  80.       "-sPAPERSIZE=a_known_paper_size"
  81.  e.g.,
  82.       "-sPAPERSIZE=a4"
  83.  or
  84.       "-sPAPERSIZE=legal"
  85.  
  86.   As of this printing, the known paper sizes, defined in gs_statd.ps, are:
  87.  
  88.   PAPERSIZE    X"         Y"         X cm      Y cm
  89.   ____________________________________________________
  90.   11x17        11"        17"        27.94     43.18
  91.   a0           33.0556"   46.7778"   83.9611   118.816
  92.   a10          1.02778"   1.45833"   2.61056   3.70417
  93.   a1           23.3889"   33.0556"   59.4078   83.9611
  94.   a2           16.5278"   23.3889"   41.9806   59.4078
  95.   a3           11.6944"   16.5278"   29.7039   41.9806
  96.   a4           8.26389"   11.6944"   20.9903   29.7039
  97.   a5           5.84722"   8.26389"   14.8519   20.9903
  98.   a6           4.125"     5.84722"   10.4775   14.8519
  99.   a7           2.91667"   4.125"     7.40833   10.4775
  100.   a8           2.05556"   2.91667"   5.22111   7.40833
  101.   a9           1.45833"   2.05556"   3.70417   5.22111
  102.   archA        9"         12"        22.86     30.48
  103.   archB        12"        18"        30.48     45.72
  104.   archC        18"        24"        45.72     60.96
  105.   archD        24"        36"        60.96     91.44
  106.   archE        36"        48"        91.44     121.92
  107.   b0           39.3889"   55.6667"   100.048   141.393
  108.   b1           27.8333"   39.3889"   70.6967   100.048
  109.   b2           19.6944"   27.8333"   50.0239   70.6967
  110.   b3           13.9167"   19.6944"   35.3483   50.0239
  111.   b4           9.84722"   13.9167"   25.0119   35.3483
  112.   b5           6.95833"   9.84722"   17.6742   25.0119
  113.   flsa         8.5"       13"        21.59     33.02
  114.   flse         8.5"       13"        21.59     33.02
  115.   halfletter   5.5"       8.5"       13.97     21.59
  116.   ledger       17"        11"        43.18     27.94
  117.   legal        8.5"       14"        21.59     35.56
  118.   letter       8.5"       11"        21.59     27.94
  119.   note         7.5"       10"        19.05     25.4
  120.  
  121. 2 Initialization_files
  122.  When looking for the initialization files (gs_*.ps), the files related
  123.  to fonts, or the file for the `run' operator, Ghostscript first tries
  124.  opening the file with the name as given (i.e., using the current
  125.  working directory if none is specified).  If this fails, and the file
  126.  name doesn't specify an explicit directory or drive, Ghostscript will
  127.  try directories in the following order:
  128.  
  129.  1. The directory/ies specified by the -I switch(es) in the command
  130.     line (see below), if any;
  131.  2. The directory/ies specified by the GS_LIB logical, if any;
  132.  3. The directory/ies specified by the GS_LIB_DEFAULT macro in the
  133.     Ghostscript makefile.
  134.  
  135.  Each of these (GS_LIB_DEFAULT, GS_LIB, and -I parameter) may be either
  136.  a single directory, or a list of directories separated by a `:'.
  137.  
  138. 2 X_resources
  139.  Ghostscript looks for the following resources under the program name
  140.  `Ghostscript':
  141.  
  142.  borderWidth
  143.   The border width in pixels (default = 1).
  144.  
  145.  borderColor
  146.   The name of the border color (default = black).
  147.  
  148.  geometry 
  149.   The window size and placement, WxH+X+Y (default is NULL).
  150.  
  151.  xResolution 
  152.   The number of x pixels per inch (default is computed from
  153.   WidthOfScreen and WidthMMOfScreen).
  154.  
  155.  yResolution
  156.   The number of y pixels per inch (default is computed from
  157.   HeightOfScreen and HeightMMOfScreen).
  158.  
  159.  useBackingPixmap
  160.   Determines whether backing store is to be used for saving display
  161.   window (default = true).
  162.  
  163.  See the file `use.txt' for a more complete list of resources.
  164.  
  165.  To set these resources, put them in a file (such as
  166.  SYS$Login:ghostscript.dat) in the following form:
  167.  
  168.       Ghostscript*geometry:    612x792-0+0
  169.       Ghostscript*xResolution: 72
  170.       Ghostscript*yResolution: 72
  171.  
  172. 2 Options
  173.  Note that VMS will convert all command line arguments to lower case
  174.  if they are not within quotes. Therefore, if a certain command does
  175.  not work, try again but with quotes around it.
  176.  
  177.   --  filename arg1 ...
  178.  Takes the next argument as a file name as usual, but takes all
  179.  remaining arguments (even if they have the syntactic form of switches)
  180.  and defines the name ARGUMENTS in userdict (not systemdict) as an
  181.  array of those strings, before running the file.  When Ghostscript
  182.  finishes executing the file, it exits.
  183.  
  184.   -Dname=token
  185.   -dname=token
  186.  Define a name in systemdict with the given definition.  The token must
  187.  be exactly one token (as defined by the `token' operator) and must not
  188.  contain any whitespace.
  189.  
  190.   -Dname
  191.   -dname 
  192.  Define a name in systemdict with value=null.
  193.  
  194.   -Sname=string
  195.   -sname=string
  196.  Define a name in systemdict with a given string as value.  This is
  197.  different from -d.  For example, -dname=35 is equivalent to the
  198.  program fragment
  199.       /name 35 def 
  200.  whereas -sname=35 is equivalent to
  201.       /name (35) def
  202.  
  203.   -q
  204.  Quiet startup - suppress normal startup messages, and also do the
  205.  equivalent of -dQUIET.
  206.  
  207.   -gnumber1Xnumber2
  208.  Equivalent to -dDEVICEWIDTH=number1 and -dDEVICEHEIGHT=number2. This is
  209.  for the benefit of devices (such as X11 windows) that require (or allow)
  210.  width and height to be specified.
  211.  
  212.   -rnumber
  213.   -rnumber1Xnumber2
  214.  Equivalent to -dDEVICEXRESOLUTION=number1 and -dDEVICEYRESOLUTION=number2
  215.  This is for the benefit of devices (such as printers) that support
  216.  multiple X and Y resolutions. (If only one number is given, it is used
  217.  for both X and Y resolutions.)
  218.  
  219.   -Idirectories
  220.  Adds the designated list of directories at the head of the search path
  221.  for library files.
  222.  
  223.  Note that gs_init.ps makes systemdict read-only, so the values of names
  224.  defined with -D/d/S/s cannot be changed (although, of course, they can
  225.  be superseded by definitions in userdict or other dictionaries.)
  226.  
  227. 2 Special_names
  228.  
  229.   -dDISKFONTS
  230.  Causes individual character outlines to be loaded from the disk the
  231.  first time they are encountered.  (Normally Ghostscript loads all the
  232.  character outlines when it loads a font.)  This may allow loading more
  233.  fonts into RAM, at the expense of slower rendering.
  234.  
  235.   -dNOCACHE
  236.  Disables character caching.  Only useful for debugging.
  237.  
  238.   -dNOBIND
  239.  Disables the `bind' operator.  Only useful for debugging.
  240.  
  241.   -dNODISPLAY
  242.  Suppresses the normal initialization of the output device. This may be
  243.  useful when debugging.
  244.  
  245.   -dNOPAUSE
  246.  Disables the prompt and pause at the end of each page. This may be
  247.  desirable for applications where another program is `driving'
  248.  Ghostscript.
  249.  
  250.   -dNOPLATFONTS
  251.  Disables the use of fonts supplied by the underlying platform (e.g.
  252.  X Windows).  This may be needed if the platform fonts look undesirably
  253.  different from the scalable fonts.
  254.  
  255.   -dSAFER
  256.  Disables the deletefile and renamefile operators, and the ability to
  257.  open files in any mode other than read-only.  This may be desirable
  258.  for spoolers or other sensitive environments.
  259.  
  260.   -dWRITESYSTEMDICT
  261.  Leaves systemdict writable.  This is necessary when running special
  262.  utility programs such as font2c and pcharstr, which must bypass normal
  263.  PostScript access protection.
  264.  
  265.   -sDEVICE=device
  266.  Selects an alternate initial output device, as described above.
  267.  
  268.   -sOutputFile=filename
  269.  Selects an alternate output file for the initial output device, as
  270.  described above.
  271.  
  272. 2 Files
  273. !!! Change
  274.  GS_Root:[Ghostscript.gs4_0]
  275.  Startup-files, utilities, and basic font definitions.
  276.  
  277.  GS_Root:[Ghostscript.Fonts4_0]
  278.  Additional font definitions.
  279.  
  280.  GS_Root:[Ghostscript.gs4_0.Examples]
  281.  Demo Ghostscript files.
  282.  
  283.  GS_Root:[Ghostscript.gs4_0.Doc]
  284.  Assorted document files.
  285. !!! Change
  286. 2 See_also
  287.  The various Ghostscript document files (above).
  288.  
  289. 2 Bugs
  290.  See the network news group comp.lang.postscript.
  291.